home *** CD-ROM | disk | FTP | other *** search
Text File | 1994-02-02 | 58.9 KB | 1,433 lines |
-
-
-
-
-
-
- Trumpet Winsock
-
-
-
- Version 1.0
-
-
-
- By Peter R. Tattam
-
-
-
- Managed by Trumpet Software International
-
-
-
-
- Copyright (C) 1993,1994 by Peter R. Tattam
-
- All Rights Reserved
-
-
- 2
-
-
- Introduction
-
- Thank you for using the Trumpet Winsock. It is through
- the kind support of many users out there that quality
- networking software has been available at affordable
- prices to the Internet community. The Trumpet Winsock is
- a Windows Sockets 1.1 compatible TCP/IP stack which
- provides a standard networking layer for many Windows(tm)
- networking applications to use, and has itself been a
- major vehicle in achieving widespread use of Windows
- Sockets 1.1. The product is a shareware item and as
- such, you are permitted to evaluate it for a period of 30
- days. If you are satisfied with its usefulness, a
- registration form is provided which you can fill out and
- send to Trumpet Software International. A registration
- fee is requested to maintain the development and support
- of this software. Suitable arrangements have been made
- for site licenses, and details can be found in a later
- section.
-
- Disclaimer & Copyright
-
- These programs are Copyright (C) 1991-1994 by Peter R.
- Tattam,
- All Rights Reserved.
-
- They are provided as shareware with the following
- limitations:
-
- These programs are shareware and are not to be
- resold or distributed for sale with other programs
- which are for sale. There is no warranty or claim
- of fitness or reliability. The programs are
- distributed AS IS, and as such neither the author,
- nor Trumpet Software International nor the
- University of Tasmania shall be held liable for
- any loss of data, down time, loss of revenue or
- any other direct or indirect damage or claims
- caused by these programs.
-
- Instructions for Installing the Trumpet Winsock.
-
- The Trumpet Winsock will only run on your PC under the
- following conditions. You must have either a packet
- driver available for use by network programs, or if you
- wish to use SLIP, a free comms port. Additionally,
- packet drivers can only be used reliably under enhanced
- mode using WINPKT. Standard mode can be used, but care
- must be taken to avoid system crashes. NDIS and ODI can
- be used via packet driver shims, but their use is not
- supported. PKTMUX may also be used instead of WINPKT,
- and must be version 1.2c or later, but again its use is
- not supported.
-
- If you already have some kind of TCP/IP networking
- package installed, it is most likely that the Trumpet
- Winsock will not run and you will have to massage your
- system configuration to install the Trumpet Winsock,
-
-
- 3
-
-
- possibly even to the extent of uninstalling that
- networking package. Alternatively, there may be a
- Winsock available for your package in which case the
- Trumpet Winsock will not be required.
-
- Installing Trumpet Winsock over Packet Driver.
-
- Firstly, if you don't know what a packet driver is, it is
- normally a small piece of software which sits in between
- your network card and your TCP program. This provides a
- standard interface which many programs can use in a
- similar manner to BIOS calls using software interrupts.
-
- Why is it called a packet driver? This is because modern
- networks send information using packets of information
- rather than sending information one byte or character at
- a time. For example, Ethernet sends information in
- frames of up to 1514 bytes long. The reason for sending
- things in packets is that information can be transmitted
- much more efficiently in packets.
-
- Central to the concept of the packet driver is the vector
- which is used to communicate with it. The 80x86 family
- of processors allows programs to communicate with the
- operating system through what is called a "software
- interrupt", which always has a number in the range 0 to
- 255. This is termed a "vector" and is the one of the key
- mechanisms to pass control to the MS-DOS operating
- system. Usually the vectors are in hexadecimal, making
- the range expressed as 0x00 to 0xFF. The 0x in front of
- the number means that we are using hexadecimal numbers
- instead of decimal numbers. They may also be expressed
- in the notation 00H to FFH, or $00 to $FF. If you are
- dealing with packet drivers, hexadecimal notation is much
- more common, but occasionally they are expressed in
- decimal. Examples of software interrupts in use on PC's
- are 0x10 for the video BIOS, or 0x21 for calls to DOS.
-
- Packet drivers are only allowed to have a software
- interrupt vector in the range 0x60 to 0x7F. Normally, you
- will pick 0x60 as the default place to install your
- packet driver, but certain machine configurations may
- make that vector unavailable. Just choose one that is
- free - the packet driver should tell you if you can use
- it or not.
-
- The Trumpet Winsock also uses a special virtual packet
- driver "wrapper" which enables your packet driver to
- function correctly in Windows. While the packet driver
- is an efficient way to communicate with your network
- card, it will not work correctly from Windows without a
- little assistance. The program "WINPKT" was written by
- some clever people on the Internet to allow a packet
- driver to work correctly within Windows by making sure
- that packets get directed to the correct "virtual
- machine" under Windows enhanced mode. A "virtual
- machine" can be either the entire Windows session, or any
-
-
- 4
-
-
- dos session active within Windows. Refer to the Windows
- system documentation for more details.
-
- In addition to this, you will need to have some
- understanding of IRQ vectors and I/O addresses that may
- be relevant to installing your network card.
-
- Where do I obtain packet drivers from?
-
- These days, packet drivers are usually provided with your
- network card, but a comprehensive collection of public
- domain packet driver can be obtained from a packet driver
- collection called the "Crynwr Packet Driver Collection."
- Information on where to get this packet driver collection
- from is provided as an appendix to this document.
-
- Actually Installing the Winsock.
-
- Before you do anything, copy the files winsock.dll,
- tcpman.exe, winpkt.com, hosts, services and protocol to a
- suitable directory.
-
- eg. c:\trumpet
-
- the essential files:
- winsock.dll the guts of the TCP/IP driver
- tcpman.exe interface program for managing the
- winsock
- winpkt.com virtual packet driver interface for
- windows
- hosts list of host names & aliases
- services list of Internet services
- protocol list of Internet protocols
-
- Modify the path line in your autoexec.bat to contain a
- reference to that directory.
-
- eg. path c:\dos;c:\windows;c:\trumpet
-
- Make sure it is active by rebooting or executing
- autoexec.bat again.
-
- The most basic setup of packet driver and WINPKT would
- look something like this example :
-
-
- ne2000 0x60 2 0x300
- WINPKT 0x60
-
-
- The first line installs an NE2000 packet driver on vector
- 0x60 using IRQ 2 and I/O address 0x300
-
- The second line installs the WINPKT virtual packet driver
- using the same vector that the ne2000 packet driver was
- installed on.
-
-
- 5
-
-
- This is of course an example so your mileage will of
- course vary. Some example configurations are described
- later in this document. Choose the one which suits you
- the best and modify it to your requirements.
-
- Now you are ready to start windows. Start it up!!
-
- From windows, start up tcpman. From the file manager, go
- File/Run, and then "tcpman". If this fails, the path is
- probably not set up correctly, so fix it. Later on, you
- can install it as an icon to use it directly.
-
- Assuming you are a first time user, a setup screen will
- appear giving you a number of options to fill in. You
- will need to fill in a few details to enable the TCP
- package to function. Fill in the following details. If
- you are unclear on any of them, try to seek some help
- from qualified Internet support staff - it will save you
- a lot of time.
-
- IP address your Internet IP address, "bootp", or
- "rarp". lower case please. If you
- use BOOTP, be sure to have a BOOTP
- service on the network or the winsock
- will not load.
- Netmask your Internet network mask. (eg.
- 255.255.0.0)
- Default Gateway your default Internet gateway. (IP
- address)
- Name server your name server IP address for DNS
- searches. You may provide more than
- one address by separating the
- addresses with spaces. (IP addresses
- only)
- Time server at present unused - future winsock
- API's may support this. (IP addresses
- only)
- Domain suffix a space separated list of domain
- suffixes to be used when resolving
- names in the DNS system.
- Packet Vector either leave this as 00 to search for
- the packet driver, or the vector that
- you installed the packet driver
- under. The number is required in
- hexadecimal without the leading "0x".
- In our example, you would provide
- "60". (numeric)
-
- MTU Maximum Transmission Unit. (numeric)
- For Ethernet, 1500 is the maximum,
- and is recommended.
- TCP RWIN TCP Receive Window (numeric) eg.
- (defaults to 4096 but can be larger)
- TCP MSS TCP Maximum Segment Size (numeric)
- (usually MTU - 40)
-
-
- 6
-
-
- The rest of the details should be greyed out and you need
- not try to fill them in. The Internal SLIP check box
- should not be checked.
-
- The first four parameters and the packet vector are
- required for successful functioning of the winsock, while
- the rest can be tailored to suit your needs.
-
- When you are done, click on <OK> and if all goes well,
- the Trumpet Winsock will be initialised. You are now
- ready to start using the winsock.
-
-
- What to do if something goes wrong
-
- Firstly...
-
- The Trumpet Winsock requires that your have the correct
- combination of tcpman.exe, winsock.dll and winpkt.com.
- When upgrading to a new release, replace each of these
- files to be sure that everything is up to date.
-
- If you get the messages about not finding a packet driver
- or unable to load TCP, then check that the packet driver
- loaded properly, that WINPKT managed to find it, and that
- the correct vector was chosen from tcpman.
-
- At the moment, only Ethernet and SLIP packet driver types
- are supported.
- Token ring is only available via the ibmtoken packet
- driver, and should work, but is untested by the author.
-
- ODI can be used via the ODIPKT shim, and NDIS via the
- DIS_PKT shim. examples are provided later on. Also,
- examples are provided of installation using NetWare.
-
- Possible causes for tcpman load errors specific to packet
- drivers.
-
- unable to bind protocol 0806 another TCP stack is
- using the packet driver...
- remove it.
- WINPKT or pktdrv not found couldn't find the correct
- packet driver. Also check
- the vector number in
- TCPMAN.
- unable to allocate network buffers critical error...
- try to free up some special
- driver memory by removing
- windows device drivers.
- network buffers low not critical but
- unadvisable... see above
-
- If WINPKT can't load (No packet driver found), check your
- packet driver vector number. Some drivers may choose a
- default vector which is not at 0x60. eg. ODIPKT default
- is 0x69
-
-
- 7
-
-
- If you are using ODIPKT and you can't get any response,
- you probably accessing the wrong protocol. If you have
- the ARP trace on, you will possibly get "ARP timed out"
- messages as well. The first parameter of ODIPKT selects
- the correct protocol. Try adjusting this.
-
- Anything else... contact me. I'll try to figure out
- what's wrong, but first browse the samples provided.
-
-
- 8
-
-
-
- Installing Trumpet Winsock over Internal SLIP
-
- SLIP is a simple protocol which allows an Async serial
- connection to send Internet Protocol (IP). You usually
- need to have access to a server which can understand
- SLIP. Usually, SLIP is accessed via a phone line, and
- with the advent of high speed modems, TCP/IP is a reality
- over a dial-up connection.
-
- The Trumpet Winsock has facilities for managing a SLIP
- connection as well as the ability to use dialling scripts
- for logging in and out of your SLIP server.
-
- Actually Installing the Winsock.
-
- Before you do anything, copy the files winsock.dll,
- tcpman.exe, hosts, services and protocol to a suitable
- directory.
-
- eg. c:\trumpet
-
- the essential files:
- winsock.dll the guts of TCP/IP driver
- tcpman.exe interface program for setting up the
- winsock
- hosts list of host names
- services list of Internet services
- protocol list of Internet protocols
-
- Modify the path line in your autoexec.bat to contain a
- reference to that
- directory.
-
- eg. path c:\dos;c:\windows;c:\trumpet
-
- Make sure it is active by rebooting or executing
- autoexec.bat again.
-
- Now you are ready to start windows. Start it up!!
-
- From windows, start up tcpman. From the file manager, go
- File/Run, and then "tcpman". If this fails, the path is
- probably not set up correctly, so fix it. Later on, you
- can install it as an icon to use it directly.
-
- Assuming you are a first time user, a setup screen will
- appear giving you a number of options to fill in. You
- will need to fill in a few details to enable the TCP
- package to function. Fill in the following details. If
- you are unclear on any of them, try to seek some help
- from qualified Internet support staff - it will save you
- a lot of time.
-
- Firstly, click on Internal SLIP. Some of the parameters
- will be greyed and others ungreyed.
-
-
- 9
-
-
- IP address your Internet IP address or "bootp".
- lower case only. Only use BOOTP if
- you are not intending to use a dial
- in script. If using a dialler script
- with the address extracted by the
- script, or BOOTP later, just leave it
- with default value of 0.0.0.0 Only
- use BOOTP if your server supports it,
- otherwise the winsock will delay for
- about 15 seconds and the message
- "Unable to load TCP" will come up.
- Name server your name server IP address for DNS
- searches. You may provide more than
- one address by separating the
- addresses with spaces. (IP addresses
- only).
- Time server at present unused - future winsock
- API's may support this. (IP addresses
- only).
- Domain suffix a space separated list of domain
- suffixes to be used when resolving
- names in the DNS system.
- MTU Maximum Transmission Unit. Related to
- TCP MSS... usually TCP MSS + 40.
- (Numeric)
- TCP RWIN TCP Receive Window. It is recommended
- that this value be roughly 3 to 4
- times the value of TCP MSS. (Numeric)
- TCP MSS TCP Maximum Segment Size, It is
- recommended that this be a smallish
- value when using SLIP - say 512 bytes
- for SLIP and lower for CSLIP. CSLIP
- is able to compress data more
- efficiently when it is less than 255.
- (numeric)
- SLIP port your comms port number ..1=com1,
- 2=com2 etc. (numeric)
- baud rate the speed you wish to run at.
- (numeric)
- hardware handshake recommended if your link
- supports it.
- Van Jacobson CSLIP
- Compression if your server will support it. You
- may also have to adjust MTU, MSS &
- RWIN. to be suitable.
- Online Status
- Detection if your modem will support it, select
- DCD or DSR on-line status detection.
-
-
- The rest of the details should be greyed out and you need
- not try to fill them in.
-
- When you are done, click on <OK> and if all goes well,
- the Trumpet Winsock will be initialised. You are now
- ready to start using the winsock.
-
- Logging in to the server.
-
-
- 10
-
-
-
- You can use either the manual login or the automatic
- scripting to access your server. For the time being,
- choose manual and log into your server with the
- appropriate commands. Don't forget to use the <esc> key
- to get out when you have finished dialling in. After
- logging in, you may need to go and set your IP address if
- it is allocated dynamically.
-
- If you wish to use another terminal program to dial in to
- the server, don't forget to issue AT&D0, or disable DTR
- dropping when exiting the program, or the connection will
- be severed when the application closes the comms port.
-
- Try out pingw to a well known host IP address to see if
- all is well.
-
- Problems
-
- Check your baud rates...
- If using hardware hand shaking with an external modem,
- make sure the cable is correctly wired.
- At the moment, all dialling must be done with 8bits, no
- parity. This may not work for you... you will then need
- to use an external dialler. The next revision will have
- an extension to the dialler to allow this.
-
- If all else fails... contact me !!
-
- Once you have determined your login sequence, you can set
- up a login script. A sample script is provided along
- with a listing of a typical session.
-
- Automatic dialling.
-
- Minimal scripting is supported, and the script commands
- are
-
- input <timeout> <string> wait for string received.
- output <string> send string.
- display <string> display string on display.
- wait <timeout> { DSR | CTS | RLSD | DCD}
- wait for DSR or CTS or
- RLSD(DCD)
- trace ( on | off ) useful for debugging
- scripts
- echo (on | off) defaults to on
- password <prompt> message box for password
- username <prompt> message box for username
- address <timeout> parse IP address
- set (DTR | RTS) (on | off) set/reset the modem lines.
- sleep <seconds> pause for so many seconds.
- exec <string> program will be started up
- concurrently using
- winexec().
- online enter SLIP mode. commands
- depending on received
- characters will not work
-
-
- 11
-
-
- correctly after this
- command is issued since the
- winsock will interpret data
- as SLIP frames. Useful
- before an exec command
- which uses the winsock.
- BOOTP inform the winsock that a
- BOOTP will be required
- after the script has
- finished.
-
- # means start comment except inside string
-
- string arguments
- \l line feed
- \r return
- \n cr/lf pair
- \f form feed
- \t tab
- \b backspace
- \nnn ASCII value in decimal
- \i IP address
- \p password
- \u username
- \c comm port number (as you have configured it)
-
- a sample script is given for logging in to our Xylogics
- terminal server.
-
- output atz\13
- input 10 OK\n
- #output atd242284\13
- output atd241644\13
- input 30 CONNECT
- input 30 \n
- wait 30 dsr
- output \13
- input 30 username:
- output tattam\13
- input 30 password:
- password Enter your password
- output \p\13
- input 30 >
- output who\13
- input 30 >
- output slip\13
- input 30 Your address is
- address 30
- input 30 \n
- display \n
- display Connected. Your IP address is \i.\n
- exec pingw 131.217.10.1
-
-
- Here's a log of a typical session. Names have been
- blanked out for security.
-
- Trumpet Winsock Version 1.00 Alpha #18
-
-
- 12
-
-
- Copyright (c) 1993 by Peter R. Tattam
- All Rights Reserved.
- SLIP ENABLED
- Internal SLIP driver COM3 Baud rate = 38400 Hardware
- handshaking
- My ip = 131.217.8.4 netmask = 255.255.0.0 gateway =
- 131.217.250.1
- Executing script c:\dev\tcpip\winsock\login.cmd
- SLIP DISABLED
- atz
- OK
- atd241644
- CONNECT 38400
-
-
- Annex Command Line Interpreter * Copyright 1991
- Xylogics, Inc.
-
- Checking authorization, Please wait...
- Annex username: xxxxxx
- Annex password:
-
- Permission granted
- University of Tasmania
- AARNet Terminal Server
-
- SLIP users:
- Use a maximum segment size (MSS) of 209
- and a maximum transmission unit (MTU) of 255.
-
- Async AppleTalk users:
- Configure MacTCP to use the Computing Centre zone.
- *** Note change in procedures for starting
- async AppleTalk.
- *** After typing atalk you will be prompted
- for your password
- *** again.
- AARNET TS5 >who
- Port What User Location When
- Idle Address
- 2 CLI xxxxxxxx --- 8:01pm
- [local]
- +1 'telnet tasman.cc'
- 3 CLI xxxxxxxx --- 8:15pm
- [local]
- +1 'rlogin franklin.cc'
- 4 SLIP modem4 --- 8:19pm
- ants
- 5 CLI xxxxxxxx --- 8:34pm
- [local]
- 6 CLI xxxxxxxx --- 7:19pm
- [local]
- +1 'rlogin baudin.cc'
- 17 SLIP modem18 --- 6:39pm
- ants
- AARNET TS5 >slip
-
- Switching to SLIP.
-
-
- 13
-
-
- Annex address is 131.217.250.10. Your address is
- 131.217.8.5.
-
- Connected. Your IP address is 131.217.8.5.
-
- Script completed
- SLIP ENABLED
-
- Dialler problems.
-
- Q. tcpman just pauses when starting up, then gives the
- message "unable to load TCP".
-
- A. You've probably got BOOTP set. Replace it by 0.0.0.0
- before dialling and try again. RARP is impossible to send
- via SLIP so don't bother with that.
-
- Q. The connection appears to be too slow compared to
- Xmodem.
-
- A. Possibly the MTU/MSS & RWIN settings are not right.
- Try to make RWIN about 3 to 4 times MSS and an exact
- multiple if possible. Turn on the IP trace to see if
- fragmentation is occurring on TCP connections. If so,
- then reduce MSS until it stops. UDP packets will still
- be fragmented, but nothing can be done about that. On
- the trace, TCP is type 6 while UDP is type 17.
-
- Q. Some input commands in the script don't work.
-
- A. Check for upper case/lower case conflicts. Also check
- for blanks at the end of the lines.
-
-
- For other problems, contact me at
-
- trumpet-bugs@petros.psychol.utas.edu.au, or subscribe to
- the Trumpet discussion group and ask your question.
- Details are at the end of this document. As time goes
- on, various FAQ's will be constructed to cope with the
- more common problems.
-
-
- 14
-
-
- Sample Configurations for Packet Driver.
-
- 1. Plain ne2000 packet driver using WINPKT.
-
- ne2000 0x60 2 0x300
- WINPKT 0x60
-
- 2. Ne2000 packet driver with Novell NetWare access using
- WINPKT.
- Important is the specification of the -n switch of the
- packet driver. Some packet drivers don't support this
- switch. In that case, you may be forced to use ODI
- instead. An example could be the Xircom Pocket Adapter.
-
- ne2000 -n 0x60 2 0x300
- WINPKT 0x60
- pdipx
- netx
- path c:\dos;c:\network\win31
- f:
- login
-
-
- 3. Ne2000 packet driver with Novell NetWare access using
- PKTMUX. Notice that WINPKT is not required since PKTMUX
- does a similar job.
-
- ne2000 -n 0x60 2 0x300
- pktmux 4
- pktdrv
- pktdrv
- pktdrv
- pktdrv
- pdipx
- netx
- path c:\dos;c:\network\win31
- f:
- login
-
- 4. ODI setup with NetWare access.
-
- You will need ODIPKT. The latest known release is 2.4 It
- is important that ODIPKT reference the correct protocol
- for IP access. This can be specified as the first
- parameter to ODIPKT (0=1st, 1=2nd and so forth)
-
- Here's a sample of my network attach batch file.
-
- @echo off
- cd \
- lh lsl
- lh \odi\ne2000
- cd \net
- lh ipxodi
- lh odipkt
- lh WINPKT 0x69
- lh netx
- path c:\dos;c:\net\win31
-
-
- 15
-
-
- f:
- echo on
- login
-
- Also, your net.cfg must be suitably configured. Here are
- the relevant excerpts from my net.cfg
-
- Link Support
- Buffers 8 1586
- MemPool 16384
-
- Link Driver NE2000
- Port #1 300 20
- Int #1 2
- Frame Ethernet_II
- Frame Ethernet_802.3
- Protocol IPX 0 Ethernet_802.3
-
-
- The ordering of the frame protocols is important for the
- default setup of ODIPKT. Also, users should be aware
- that there are two versions of ODIPKT, one released I
- believe by FTP Software, and the public domain one. I
- refer to the public domain version. Also note that there
- are two programs with the same name of "ne2000.com". One
- is a packet driver and is referred to in an earlier
- section. The one referred to in this section is actually
- an ODI driver and won't function as a packet driver at
- all.
-
- 5. NDIS & Windows for Workgroups setup. (courtesy of
- Peter Whisker, WhiskerP@LGWCT.LOGICA.COM)
-
- Installation of Trumpet Winsock makes use of the
- DIS_PKT9.DOS or DIS_PKT.DOS shims which provide a Packet
- Driver interface the NDIS. The version I have tested is
- found on a number of sites as DISPKT11.ZIP, and contains
- DIS_PKT.DOS dated 28/4/93. The example is based upon an
- actual configuration using DEC Pathworks version 4.1
- (DECNET version) with a DEPCA Ethernet card. This
- installation assumes that you have NDIS up and running
- and have a valid PROTOCOL.INI file.
-
- You need to perform three basic steps:
- Load the DIS_PKT driver in CONFIG.SYS following the
- load of PROTMAN.SYS:
-
- DEVICEHIGH=\DECNET\PROTMAN.SYS /I:C:\DECNET
- DEVICEHIGH=\DECNET\DEPCA.DOS
- DEVICEHIGH=\DECNET\DIS_PKT.DOS
-
- Add a few lines to PROTOCOL.INI (here labelled
- [PKTDRV]) in order to bind it to the Ethernet driver.
- In this example, DIS_PKT.DOS is configured with packet
- vector 60.
-
- [DEPCA.DOS]
- DRIVERNAME = DEPCA$
-
-
- 16
-
-
- .
- .
- .
- [PKTDRV]
- DRIVERNAME = PKTDRV
- BINDINGS = DEPCA.DOS
- INTVEC = 0x60
-
- In AUTOEXEC.BAT, load WINPKT or PKTMUX as described in
- examples 2 and 3 above. This should be done after the
- NETBIND command in your NDIS startup has been executed.
- In the case of Pathworks, this command is normally
- contained in STARTNET.BAT. For example:
-
- call \decnet\startnet.bat
- WINPKT 0x60
-
-
- 6. Some more packet driver installations courtesy of
- Ashok Aiyar (ashok@biochemistry.bioc.crwu.edu)
-
- Configuration for Cabletron Network Cards. The packet
- driver provided by Cabletron is a little confusing as it
- doesn't use the same parameters as packet-drivers that
- use the Crynwr skeleton.
-
- Typically the Cabletron driver is loaded as:
-
- "csipd_e /s:62 /h:7 /p:300"
-
- In this example the software interrupt is 0x62. Load
- winpkt.com as
-
- "WINPKT 0x62"
-
- Release 11 of the Crynwr packet drivers includes a driver
- for Cabletron cards written by Kai Getrost using the
- Crynwr skeleton that uses the same parameters as the
- other Crynwr drivers. This driver (CTRONDNI.COM) seems
- to work well with E1020/1040 and E2020 Cabletron cards.
- Indeed I see a performance gain over the Cabletron
- driver. Your mileage may vary.
-
- C/SLIPPER with PKTMUX. Although the Trumpet Winsock has
- built in support for C/SLIP, there are situations when in
- addition to Winsock applications there is a need to run
- packet driver applications simultaneously over a SLIP
- link. For such situations, PKTMUX is of utility.
-
- Example:
-
- CSLIPPER vec=65 com1 irq=04H baud=57600 ether
- PKTMUX 4 65 /4 .... (support for a maximum of 4 virtual
- packet drivers)
- PKTDRV 60 65
-
- Configure the Trumpet Winsock to use the virtual packet
- driver at 0x60. All other virtual packet drivers
-
-
- 17
-
-
- (PKTDRV) can be loaded in the DOS Windows in which they
- are used. They need not be loaded before entering
- Windows.
-
- (Ed. Note... You may also require the use of a special
- comms buffer to enhance the buffering capabilities of
- Windows when using slipper/cslipper. An FAQ on doing
- this is available from biochemistry.bioc.cwru.edu via
- gopher or FTP. It is not needed when using the internal
- SLIP functions of the Winsock)
-
- Extra Info
-
- You may use environment variables or command line options
- to override some of the network parameters. They have
- the same names as the saved parameters in trmpwsk.ini.
- This file normally resides in the winsock directory
- rather than the windows directory since this facilitates
- setting up the winsock in a networked environment. IP
- addresses can be overridden by using the environment
- variables, or the command line.
-
- example of command line.
-
- tcpman -ip=123.231.213.123 -netmask=255.255.255.0
-
- example of environment variable
-
- set ip=123.231.213.123
- set netmask=255.255.255.0
-
- Here's a list of parameters.
-
- ip/myip your IP address or 'bootp' or 'rarp'
- (lower case only)
- netmask your netmask. eg. 255.255.0.0
- gateway/mygatewayyour gateway (IP address)
- dns list of DNS IP addresses
- time list of time server IP addresses
- domain list of domain name suffixes
- vector packet driver vector in hex
- MTU Maximum Transmission Unit
- RWIN TCP Receive Window.
- MSS TCP Maximum Segment Size
- slip-enabled 0 = off, 1 = on
- slip-port port number (1-9)
- slip-baudrate baud rate in decimal
- slip-handshake 0 = off, 1 = on
- slip-compressed 0 = off, 1 = on
-
- The Crynwr packet driver collection
-
- Availability
-
- The Crynwr packet driver collection is available by mail,
- by FTP, by e-mail, by UUCP and by modem. The drivers are
- distributed in three files: drivers.zip, which contains
- executables and documentation, drivers1.zip, which
-
-
- 18
-
-
- contains the first half of the .ASM files, and
- drivers2.zip, which contains the second half of the .ASM
- files.
-
- Mail:
-
- Columbia University distributes packet drivers by mail.
- The formats are 9-track 1600 bpi tapes in ANSI, tar, or
- OS SL format, or PC diskettes (360K 5.25" and 720K 3.5").
- The exact terms and conditions have yet to be worked out,
- please call (212) 854-3703 for ordering information, or
- write to:
-
- Kermit Distribution, Dept PD
- Columbia University Center for Computing Activities
- 612 West 115th Street
- New York, NY 10025
-
- or send e-mail to kermit@watsun.cc.columbia.edu
- (Internet) or
- KERMIT@CUVMA (BITNET/EARN).
-
-
- FTP/e-mail:
-
- The packet driver collection has its own directory
- devoted to it, pd1:<msdos.pktdrvr>. The drivers are
- there, along with many free programs that use the packet
- drivers.
-
- SIMTEL20 files are also available from mirror sites
- OAK.Oakland.Edu
- (141.210.10.117), wuarchive.wustl.edu (128.252.135.4),
- ftp.uu.net (192.48.96.9), nic.funet.fi (128.214.6.100),
- src.doc.ic.ac.uk (146.169.3.7) or rana.cc.deakin.oz.au
- (128.184.1.4), or by e-mail through the BITNET/EARN file
- servers.
-
- Modem:
-
- If you cannot access them via FTP or e-mail, most
- SIMTEL20 MSDOS files, including the PC-Blue collection,
- are also available for downloading from Detroit Download
- Central (313) 885-3956. DDC has multiple lines which
- support 300/1200/2400/9600/14400 bps
- (103/212/V22bis/HST/V32bis/V42bis/MNP). This is a
- subscription system with an average hourly cost of 17
- cents. It is also accessable on Telenet via PC Pursuit
- and on Tymnet via StarLink outdial. New files uploaded
- to SIMTEL20 are usually available on DDC within 24 hours.
-
- CD-ROM:
-
- Public, private or corporate institutions and libraries
- interested in the SIMTEL20 MSDOS collection in CD-ROM
- format bundled with library card-catalog type access and
- duplication software can contact Coyote Data, Ltd. by
-
-
- 19
-
-
- mail at 1142 N. Main, Rochester, MI 48307 or by FAX at
- (313) 651-4071.
-
- UUCP:
-
- The packet driver files are available from UUNET's 1-900-
- GOT-SRCS, in uunet!~/systems/msdos/simtel20/pktdrvr. See
- UUNET.DOC for details.
-
- ODIPKT location
-
- I am told that the originating site for ODIPKT is the
- following...
-
- Host hsdndev.harvard.edu
-
- Location: /pub/odipkt
- FILE -rwxr-xr-x 2915 Aug 21 20:01
- odipkt.com
-
- A copy of the NDIS shim is there also.
-
-
- 20
-
-
-
- Trumpet General Discussion Group.
-
- The machine petros.psychol.utas.edu.au is now running a
- local news service with the news groups
-
- trumpet.announce
- trumpet.bugs
- trumpet.feedback
- & trumpet.questions
-
- If you do not have access directly to this service, these
- news groups are gatewayed to the following mailing list.
-
- You may join the new Trumpet mailing list by sending a
- message to
-
- listproc@petros.psychol.utas.edu.au
-
- with just one line in the body.
-
- subscribe trumpet-user Your Full Name
-
- Where "Your Full Name" should be replaced by your actual
- full name.
-
- The list is called
-
- trumpet-user@petros.psychol.utas.edu.au
-
-
- and is running on a 486/50 FreeBSD system. Hopefully it
- will cope ;-)
-
- You can ask questions, or discuss any aspect of any
- Trumpet program on this group. Feedback is always
- welcome. There is also an anonymous FTP area with all
- the latest Trumpet programs and pre-releases. If you do
- use a pre-release, be prepared for unexpected problems
- since such programs are in alpha/beta test.
-
-
- Bugs or Comments
-
- Send to
-
- trumpet-bugs@petros.psychol.utas.edu.au
-
- For bug reports, please send a copy of config.sys,
- autoexec.bat, trumpwsk.ini, and any other relevant
- network configurations. In the case of ODI, also send
- net.cfg. We will do my best to sort out your problem.
- Due to the high demand for the Trumpet Winsock, my mail
- box can be overloaded at times. Be patient... someone
- will answer you.
-
-
- 21
-
-
- TCPMAN - The Trumpet Winsock TCP Manager
-
- Menu options.
-
- File/Setup calls up the setup dialog for
- configuration
-
- IP address your IP address, "bootp" or
- "rarp" (lower case).
- BOOTP will only work if there is
- a BOOTP service on-line.
- RARP will only work if using
- Ethernet, and there is an RARP
- service on-line.
- Netmask your network mask.
- Default gateway your default Internet gateway or
- router.
- Name server your Domain Name Server address.
- Time server (unused leave empty)
- Domain Suffix A space separated list of
- suffixes to be tried when
- looking up names via the name
- server.
- Packet Vector for accessing the packet driver
- in hex.
- MTU Maximum Transmission Unit.
- TCP RWIN TCP Receive Window
- TCP MSS TCP Maximum Segment Size
-
- Demand Load Timeout Number of seconds tcpman stays
- loaded after the application has
- finished with it.
-
- Internal SLIP Click on this for internal SLIP
- support & dialler support.
- SLIP port which comms port to use.
- Baud Rate speed of the connection.
- Hardware Handshaking turn on for RTS/CTS
- handshaking. May require the
- AT&K3 modem command to function
- properly.
- Van Jacobson CSLIP compression
- turn on for CSLIP TCP header
- compression.
-
- Online Status Detection needed for dialler
- autologin / autologout enabling.
- None no online status detection
-
- DCD (RLSD) check may require AT&C1 modem command
- to function.
-
- DSR check may require AT&S1 modem command
- to function.
-
-
- 22
-
-
- File/Register calls up the registration dialog.
- File/Exit quits the TCP manager, forcing the
- winsock to be unloaded.
-
- Edit/Copy copy selected text on tcpman display
- to the clipboard
- Edit/Clear clear the tcpman display
-
- Tracing options. Use with care since some applications
- may crash when the traces are active. Should a program
- crash with stack overflow, the winsock may remain loaded
- in memory even though tcpman has exited. It is advisable
- to restart windows if this happens and possibly even to
- reboot your machine. Also, timing measurements of the
- winsock throughput will be severely affected by the trace
- options.
-
- Trace/TCP turn TCP trace on/off
- Trace/UDP turn UDP trace on/off
- Trace/IP turn IP tracing on/off
- Trace/ARP turn ARP tracing on/off
- Trace/RARP turn RARP tracing on/off
- Trace/Ethernet add Ethernet headers to IP/ARP/RARP
- traces.
- Trace/Extra detail add some extra detail to TCP, UDP &
- IP traces.
- Trace/Socket calls trace each winsock call.
- most parameters are displayed as
- well.
- Trace/DNS trace Domain Name Server operations.
- Use with care, stack overflows can be
- frequent.
- Trace/Messages trace Async Socket messages.
-
-
- 23
-
-
-
- Dialler/Login invoke the login.cmd dialler script.
- Dialler/Bye invoke the bye.cmd dialler script.
- Dialler/Other invoke other scripts.
- a file selection dialog of *.cmd will
- be
- displayed.
- Dialler/Options call up the dialler options dialog.
-
- No automatic login
- Automatic login on startup only.
- Automatic login and logout on demand.
-
- SLIP inactivity timeout (minutes) Number of minutes
- to wait before exiting
- winsock. (when no
- application is using the
- winsock.) Automatic login
- & logout must be enabled
- for this to close the SLIP
- connection. A value of 0
- disables the timeout.
-
- Dialler/Manual Login invoke the dialler manually.
- Use <esc> to exit from the manual
- dialler.
- Dialler/Edit Scripts invokes notepad to edit any
- script.
-
- Help/About Display the version number and
- copyright.
-
-
- 24
-
-
- Registration
-
-
- Registration of the Trumpet Winsock is encouraged since
- it funds further development of the winsock. It involves
- sending in a registration form filled in with your
- registration name and other details. On receipt of your
- registration, you will receive a password which will
- remove the UNREGISTERED VERSION notice and replace it
- with your registration name. As part of this
- registration, you will receive enough support to get you
- going within the existing capabilities of the winsock at
- the present time, and preference will be given to
- registered users when it comes to bug fixes or future
- enhancements to the winsock. Packet drivers using
- Ethernet and SLIP are presently the only supported
- network access. The winsock will function through the
- use of packet driver shims for ODI, NDIS and token ring,
- but the use of these is not supported, neither is the
- winsock supported should you be using PKTMUX.
-
-
- The Trumpet Winsock is currently distributed as
- shareware. You may use the Trumpet Winsock for 30 days to
- evaluate its usefulness. If at the end of that time you
- are satisfied with the Trumpet Winsock as a product, you
- can register it. The basic registration fee for a single
- user version of the Trumpet Winsock is US$20. See a
- later section for details on multi-user site licenses.
-
- Australian users should contact me regarding Australian
- pricing information and availability.
-
- Cheques or Postal Orders should be made out to
-
- Trumpet Software International
-
- and sent to
-
- Trumpet Software International
- GPO Box 1649,
- HOBART, TAS AUSTRALIA 7001
-
- You should fill out the following order form and send it
- along with your cheque or Postal Order to the above
- address.
-
- FAX/Phone International 61-02-487049, Australia 002-
- 487049
-
- Please note that International mail can be rather slow,
- and it may take up to 2 months to receive your
- registration.
-
-
- 25
-
-
-
- +----------------------------------------------+
- | O R D E R F O R M |
- | for Trumpet Winsock version 1.0 Software |
- +----------------------------------------------+
-
-
-
-
-
-
- Ship to: Bill to:
-
- [ ] [
- ]
- [ ] [
- ]
- [ ] [
- ]
- [ ] [
- ]
- [ ] [
- ]
-
-
- Please supply the following items:
-
- ---------------------------------------------------------
- -------------
-
- Licence to use Trumpet Winsock 1.0 for [ ] users
- . . . .
- . US$[ ]
-
- Tick at least one of the following options.
- [ ] 5.25" disk with the latest version of Trumpet Winsock
- + password
- [ ] 3.5" disk with the latest version of Trumpet Winsock
- + password
- [ ] registration password via post
- [ ] registration password via e-mail
-
- Your registration name (required) (will appear on
- program)
-
- [________________________________________________________
- ____________]
-
- Your e-mail address (optional - print clearly)
- [________________________________________________________
- ____________]
-
-
- Date sent [______________] Expected delivery Date
- [_______________]
-
-
- 26
-
-
- Site Licenses
-
- A site license is defined as being a sale to an
- organisation or company, and may not be resold or
- redistributed for profit. It may only be used within that
- organisation.
-
- prices valid until 30-Jun-1994
-
- Single User license
-
- 1 user $20 US
-
- Multi-user site license
-
- Trumpet Winsock will be charged by the number of
- simultaneous users.
- The pricing structure for commercial users is thus
-
- 1-99 users $20 US per user
- 100-499 users $2000 US + $10 US per additional user
- over 100
- 500-999 users $6000 US + $5 US per additional user
- over 500
- 1000+ users $8500 US + $2 US per additional user
- over 1000
-
- site restriction 10km radius (negotiable)
-
- Unlimited Commercial Site License
-
- $10,000 US for first year.
- subsequent years, 25% of unlimited site license fee
- for that year.
- site restriction 100km radius (negotiable)
-
- The pricing structure for educational users is thus
-
- 1-100 users $20 US per user
- 100+ $2000 US
-
- site restriction unlimited.
-
- Your site license will give you support for up to 12
- months from the date of purchase. Such support will
- include upgrades and bug fixes within that 12 months
- within the constraints of the program's existing
- capabilities. Future upgrades will be 25% of the
- original license fee per annum. Arrangements will also
- be made for conversion of smaller licenses to larger
- ones.
-
-
- 27
-
-
-
- Should you wish to obtain the Trumpet Winsock to
- distribute with other programs, you should make a
- suitable offer to Trumpet Software International, and it
- will be considered. Source code will not be made
- available under any circumstances, and Trumpet Software
- International reserves the right not to accept any offer
- which is not considered acceptable.
-
- Trumpet Software International
- GPO Box 1649,
- HOBART, TAS AUSTRALIA 7001
-
- FAX/Phone International 61-02-487049, Australia 002-
- 487049